Introducción a la confección de informes con Quarto

Taller introductorio a la Ciencia de Datos con R

Jan Strappa

Introducción a la confección de informes con Quarto

  • Introducción a Quarto
  • Aspectos básicos de YAML para la estructura del informe
  • Contenido: bloques de código, texto con formato, estilos
  • Renderización de informes en formato html, pdf y docx
  • Compartir y presentar reportes

Sobre R-Ladies Mendoza

R-Ladies Mendoza es parte de una organización mundial para promover la Diversidad de Género en la comunidad R.

¿Dónde pueden enterarse de nuestras actividades?

¿Qué es Quarto?

Sobre Quarto

Quarto (.qmd): es un sistema de código abierto para publicaciones científicas y técnicas.

Permite crear muchos tipos de publicaciones, tales como artículos, informes, sitios web, libros, blogs.

Instalación de R, RStudio y Quarto

¿Qué herramientas usás actualmente para crear tus reportes?

¡Vamos al quiz!

https://www.menti.com/alqanvnvc7zv

¿Por qué usar Quarto?

  • No necesitas saber de programación para usar Quarto
  • Los documentos están en texto plano: se puede usar cualquier editor
  • Software libre: comunidad, ayuda y tutoriales online, filosofía orientada a compartir conocimiento
  • Permite transparencia y reproducibilidad: ideal para investigadores
  • Mayor control sobre el contenido, más fácil de mantener: combina código, texto, referencias bibliográficas e imágenes en un solo lugar.
  • Muchas opciones de formatos y publicación online (gratuitas o pagas)

Un poco de historia y contexto

  • Markdown (.md): lenguaje de marcado de documentos (markup)
  • Quarto (.qmd): sistema open source para publicaciones (Markdown + código)
Un encabezado de primer nivel
=============================

Un encabezado de segundo nivel
------------------------------

Algunas palabras *tienen énfasis*.
Las palabras siguientes _también tienen énfasis_.

Usamos dos asteriscos para **mayor énfasis**.
O, si preferís, usá __dos guiones bajos__.

### Encabezado 3

> Esto es una cita.
>
> ## Esto es un encabezado dentro de una cita

Una lista

- un item
- otro item

Una lista ordenada

1. un paso
1. otro paso

Herramientas y formatos que usaremos

Nombre Extensión Uso
Quarto .qmd contenido
YAML .yml configuración
CSS .css estilo
HTML .html salida

Proceso

  1. El IDE crea la estructura del proyecto de publicación
  2. nos enfocamos en el contenido y estilo
  3. El IDE renderiza el proyecto
  4. repetimos pasos 2 y 3
  5. publicamos (para proyecto online)

Crear proyecto en RStudio

Crear proyecto en RStudio

Mi primer archivo qmd


---
title: "mi_reporte"
---

## Quarto

Quarto enables you to weave together content and executable code into a finished document. To learn more about Quarto see <https://quarto.org>.


'```{r}
1 + 1
'```

Distintas salidas

  1. Agregamos format: pdf en el YAML
---
title: "mi_reporte"
format:
  pdf
---
  1. “render” →

Descargamos ejemplo

https://github.com/jsgarriga/demostracion-analisis-r-eph/blob/main/taller_2.qmd

Configurando el reporte con YAML

---
title: 'Taller II: Uso de R para analizar los datos de la Encuesta Permanente de Hogares (INDEC, Argentina)'
subtitle: 'Demostración para el Taller introductorio a la Ciencia de Datos con R: Manipulación de datos utilizando el ecosistema Tidyverse'
author:
  - name: Jess Garriga
date: "09/03/2023"
lang: es
format:
  html:
    toc: true
    toc-depth: 4
    toc-location: left
    code-fold: false
    code-summary: Mostrar código
    code-tools: true
    code-link: true
    self-contained: true
execute:
  enabled: true
---

Ejemplo

Continuamos con el ejemplo en RStudio…

¡Gracias por participar!

¿Dudas? ¿Consultas?

Enlaces útiles

Introducción a R